Resource URL: /platform/<<version=5>>/local/cluster/nodes/<LNN>/drives/<DRIVEID>

    Overview: This resource provides information about a specific drive on a
              specific node, such as the model, serial number, and location of
              the drive in the node.  LNN in the resource path is the desired
              node's LNN.  DRIVEID is the desired drive's ID.

     Methods: GET

********************************************************************************

Method GET: Retrieve drive information.

       URL: GET
            /platform/<<version=5>>/local/cluster/nodes/<LNN>/drives/<DRIVEID>

There are no query arguments for this method.

GET response body schema:
{
  "type": [
    {
      "additionalProperties": false, 
      "type": "object", 
      "description": "A list of errors that may be returned.", 
      "properties": {
        "errors": {
          "items": {
            "additionalProperties": false, 
            "type": "object", 
            "description": "An object describing a single error.", 
            "properties": {
              "field": {
                "type": "string", 
                "description": "The field with the error if applicable."
              }, 
              "message": {
                "type": "string", 
                "description": "The error message."
              }, 
              "code": {
                "type": "string", 
                "description": "The error code."
              }
            }
          }, 
          "type": "array"
        }
      }
    }, 
    {
      "additionalProperties": false, 
      "type": "object", 
      "properties": {
        "nodes": {
          "minItems": 0, 
          "items": {
            "type": "object", 
            "description": "Information about this node's drives.", 
            "properties": {
              "lnn": {
                "type": "integer", 
                "description": "Logical Node Number (LNN) of this node."
              }, 
              "drives": {
                "items": {
                  "type": "object", 
                  "description": "Drive information.", 
                  "properties": {
                    "bay_group": {
                      "type": "string", 
                      "description": "The name of the bay group this drive belongs to."
                    }, 
                    "lnum": {
                      "type": "integer", 
                      "description": "This drive's logical drive number in IFS."
                    }, 
                    "baynum": {
                      "type": "integer", 
                      "description": "Numerical representation of this drive's bay."
                    }, 
                    "purpose_description": {
                      "type": "string", 
                      "description": "Description of this drive's purpose."
                    }, 
                    "handle": {
                      "type": "integer", 
                      "description": "Drive_d's handle representation for this drive"
                    }, 
                    "serial": {
                      "type": "string", 
                      "description": "Serial number for this drive."
                    }, 
                    "wwn": {
                      "type": "string", 
                      "description": "The drive's 'worldwide name' from its NAA identifiers."
                    }, 
                    "logical_block_length": {
                      "type": "integer", 
                      "description": "Size of a logical block on this drive."
                    }, 
                    "ui_state": {
                      "type": "string", 
                      "description": "This drive's state as presented to the UI."
                    }, 
                    "physical_block_length": {
                      "type": "integer", 
                      "description": "Size of a physical block on this drive."
                    }, 
                    "firmware": {
                      "type": "object", 
                      "description": "Drive firmware information.", 
                      "properties": {
                        "desired_firmware": {
                          "type": "string", 
                          "description": "This drive's desired firmware revision."
                        }, 
                        "current_firmware": {
                          "type": "string", 
                          "description": "This drive's current firmware revision"
                        }
                      }
                    }, 
                    "pending_actions": {
                      "items": {
                        "type": "string"
                      }, 
                      "type": [
                        "array", 
                        "null"
                      ], 
                      "description": "This drive's current outstanding actions. For example, \"add\" or \"firmware_update\"."
                    }, 
                    "media_type": {
                      "type": "string", 
                      "description": "String representation of this drive's media type."
                    }, 
                    "interface_type": {
                      "type": "string", 
                      "description": "String representtation of this drive's interface type."
                    }, 
                    "blocks": {
                      "type": "integer", 
                      "description": "Number of blocks on this drive."
                    }, 
                    "devname": {
                      "type": "string", 
                      "description": "This drive's device name."
                    }, 
                    "chassis": {
                      "type": "integer", 
                      "description": "The chassis number which contains this drive."
                    }, 
                    "purpose": {
                      "type": "string", 
                      "description": "This drive's purpose in the DRV state machine."
                    }, 
                    "y_loc": {
                      "type": "integer", 
                      "description": "This drive's y-axis grid location."
                    }, 
                    "x_loc": {
                      "type": "integer", 
                      "description": "This drive's x-axis grid location."
                    }, 
                    "present": {
                      "type": "boolean", 
                      "description": "Indicates whether this drive is physically present in the node."
                    }, 
                    "locnstr": {
                      "type": "string", 
                      "description": "String representation of this drive's physical location."
                    }, 
                    "model": {
                      "type": "string", 
                      "description": "This drive's manufacturer and model."
                    }
                  }
                }, 
                "type": "array", 
                "description": "List of the drives in this node."
              }, 
              "id": {
                "type": "integer", 
                "description": "Node ID (Device Number) of this node."
              }
            }
          }, 
          "type": "array", 
          "maxItems": 4294967295
        }, 
        "total": {
          "minimum": 0, 
          "type": "integer", 
          "description": "Total number of items available.", 
          "maximum": 4294967295
        }
      }
    }
  ]
}
